QtDBus是一个使用D-Bus协议进行进程间通信的仅在Unix运行的库，是对D-Bus底层API的封装实现。 QtDBus模块提供了使用Qt信号槽机制扩展的接口。要使用QtDBus模块，需要在代码中加入以下代码：

如果使用qmake构建程序，需要在工程文件中增加下列代码来链接QtDBus库：

D-Bus有一种基于几种原生与在数组和结构中的原生类型组成的复合类型的扩展类型系统。QtDBus模块通过QDBusArgument类实现了类型系统，允许用户通过总线发送和接收每一种C++类型。

QtDBus通过QDBusArgument支持原生类型，不需要特殊的定制。

除了原生类型，QDBusArgument也支持在Qt应用中广泛使用的两种非原生类型，QStringList和QByteArray。

D-Bus指定由原生类型聚合而成的三种复合类型：ARRAY、STRUCT和 maps/dictionaries。ARRAY零个或多个相同元素的集合，STRUCT是由不同类型的固定数量的元素组成的集合，Maps or dictionaries是元素对的数组，一个map中可以有零个或多个元素。

为了在QtDBus模块使用自定义类型，自定义类性必须使用Q_DECLARE_METATYPE()声明为Qt元类型，使用qDBusRegisterMetaType()函数注册。流操作符会被注册系统自动找到。 QtDBus模块为Qt容器类使用数组和map提供了模板特化，例如QMap和QList，不必实现流操作符函数。对于其它的类型，流操作符必须显示实现。

QtDBus定义的所有类型能用于通过总线发送和接收消息。不能使用上述类型之外的任何类型，包括typedefs定义的列表类型，如

QDBusMessage类表示D-Bus总线发送或接收的一个消息。 QDBusMessage对象代表总线上四种消息类型中的一种，四种消息类型如下： A、Method calls B、Method return values C、Signal emissions D、Error codes 可以使用静态函数createError()、createMethodCall()、createSignal()创建消息。使用QDBusConnection::send() 函数发送消息。

QDBusConnection代表到D-Bus总线的一个连接，是一个D-Bus会话的起始点。通过QDBusConnection连接对象，可以访问远程对象、接口，连接远程信号到本地槽函数，注册对象等。 D-Bus连接通过connectToBus()函数创建，connectToBus()函数会创建一个到总线服务端的连接，完成初始化工作，并关联一个连接名到连接。 使用disconnectFromBus()函数会断开连接。一旦断开连接后，调用connectToBus()函数将不会重建连接，必须创建新的QDBusConnection实例。 作为两种最常用总线类型的辅助，sessionBus()和systemBus()函数分别创建到会话在总线和系统总线的连接并返回，会在初次使用时打开，在QCoreApplication析构函数调用时断开。 D-Bus支持点对点通信，不必使用总线服务。两个应用程序可以直接交流和交换消息。可以通过传递一个地址到connectToBus()函数实现。 QDBusConnection connectToBus(BusType type, const QString & name) 打开一个type类型的连接，并关联name连接名，返回关联本连接的QDBusConnection对象。 QDBusConnection connectToBus(const QString & address, const QString & name) 打开一个地址为address的私有总线，并关联name连接名，返回关联本连接的QDBusConnection对象。 QDBusConnection connectToPeer(const QString & address, const QString & name) 打开一个点对点的连接到address地址，并关联name连接名，返回关联本连接的QDBusConnection对象。 void disconnectFromBus(const QString & name) 关闭名为name的总线连接 void disconnectFromPeer(const QString & name) 关闭名为name的对等连接 QByteArray localMachineId() 返回一个D-Bus总线系统知道的本机ID QDBusConnection sender() 返回发送信号的连接 QDBusConnection sessionBus() 返回一个打开到session总线的QDBusConnection对象 QDBusConnection systemBus() 返回一个打开到system总线的QDBusConnection对象 QDBusPendingCall asyncCall(const QDBusMessage & message, int timeout = -1)const 发送message消息到连接，并立即返回。本函数只支持method调用。返回一个用于追踪应答的QDBusPendingCall对象。 QDBusMessage call(const QDBusMessage & message, QDBus::CallMode mode = QDBus::Block, int timeout = -1 ) const 通过本连接发送消息message，并且阻塞，等待应答。 bool registerObject(const QString & path, QObject * object, RegisterOptions options = ExportAdaptors) 注册object对象到路径path，options选项指定由多少对象会被暴露到D-Bus总线，如果注册成功，返回true。 bool registerService(const QString & serviceName) 试图在D-Bus总线上注册serviceName服务，如果注册成功，返回true；如果名字已经在其它应用被注册，则注册失败。

QDBusInterface是远程对象接口的代理。 QDBusInterface是一种通用的访问器类，用于调用远程对象，连接到远程对象导出的信号，获取/设置远程属性的值。当没有生成表示远程接口的生成代码时时，QDBusInterface类对远程对象的动态访问非常有用。 调用通常是通过使用call（）函数来实现，call函数构造消息，通过总线发送消息，等待应答并解码应答。信号使用QObject::connect()函数进行连接。最终，使用QObject::property()和QObject::setProperty()函数对属性进行访问。

QDBusReply类用于存储对远程对象的方法调用的应答。 一个QDBusReply对象是方法调用的应答QDBusMessage对象的一个子集。QDBusReply对象只包含第一个输出参数或错误代码，并由QDBusInterface派生类使用，以允许将错误代码返回为函数的返回参数。

对于没有输出参数或返回值的远程调用，使用isValid()函数测试应答是否成功。

QDBusAbstractAdaptor类使用D-Bus Adaptor基类。 QDBusAbstractAdaptor类是用于使用D-Bus向外部提供接口的所有对象的起点。可以通过将一个或多个派生自QDBusAbstractAdaptor的类附加到一个普通QObject对象上，使用QDBusConnection::registerObject注册QObject对象可以实现。QDBusAbstractAdaptor是一个轻量级封装，主要用于中继调用实际对象及其信号。 每个QDBusAbstractAdaptor派生类都应该使用类定义中的Q_CLASSINFO宏来定义D-Bus接口。注意，这种方式只有一个接口可以暴露。 QDBusAbstractAdaptor使用了信号、槽、属性的标准QObject机制来决定哪些信号、槽、属性被暴露到总线。任何QDBusAbstractAdaptor派生类发送的信号通过任何D-Bus连接自动中继到注册的对象上。 QDBusAbstractAdaptor派生类对象必须使用new创建在堆上，不必由用户删除。

QDBusAbstractInterface是QtDBus模块中允许访问远程接口的所有D-Bus接口的基类。 自动生成的代码类也继承自QDBusAbstractInterface，此描述的所有方法在生成的代码中也有效。除了此处的描述，生成代码类为远程方法提供了成员函数，允许在编译时检查正确参数和返回值，以及匹配的属性类型和匹配的信号参数。

调用本接口中的method方法，传递参数到远程的method。 要调用的参数会通过D-Bus输入参数传递到远程方法，返回的QDBusPendingCall对象用于定义应答信息。 本函数最多有8个参数，如果参数多于8个，或是传递可变数量的参数，使用asyncCallWithArgumentList()函数。

QDBusArgument类用于整理和分发D-Bus参数。QDBusArgument用于通过D-Bus发送参数到远程应用，并接收返回。 QDBusArgument是QtDBus类型系统的核心类，QtDBus类型系统用于解析和原生类型。复合类型可以通过在数组、词典或结构中使用一个或多个原生类型创建。 下列代码展示了使用QtDBus类型系统构造的包含一个整数和字符串的结构。

在QDBusArgument使用这个结构前，必须使用qDBusRegisterMetaType()函数进行注册。因此，在程序中应该则增加如下代码： qDBusRegisterMetaType(); 一旦注册，类型可以在呼出方法调用（QDBusAbstractInterface::call()）、来自注册对象的信号发射或来自远程应用的传入调用。

QDBusConnectionInterface类提供了对D-Bus总线服务的访问。 D-Bus总线服务端中提供了一个特殊的接口org.freedesktop.DBus，允许客户端运行访问总线的某些属性，例如当前连接的客户端列表，QDBusConnectionInterface类提供对org.freedesktop.DBus接口的访问。 本类中最常用的是使用registerService()和unregisterService()在总线上注册和注销服务名。 QDBusConnectionInterface类定义四个信号，在总线上有服务状态变化时发送。

QDBusVariant类使程序员能够识别由D-Bus类型系统提供的Variant类型。一个使用整数、D-Bus变体类型和字符串作为参数的D-Bus函数可以使用如下的参数列表调用。